Copyright © Speakerbus Technology Ltd. All Rights Reserved.
This readme contains important information about this release.
Note:
The preferred method of upgrading iG330 is to use the secure upgrader method described in this section. This will automatically upgrade the application software and also the bootloader,
kernel and kernel modules if they have changed. Since this method is only possible from v2.700.1.0 onwards, to upgrade from, or downgrade to, any earlier versions in future it will be necessary to first always
install a suitable 2.700 to 2.73x version first.
If it is not possible to apply the upgrade using this methods, for example if no existing application software is installed and running,
then please follow the full installation instructions below.
Note that this process will preserve the web server passwords and any installed certificate, together with the unit's configuration.
1. Copy the following file into a suitable directory accessible by the TFTP server; the use of a sub-directory is optional.
| (version-specific encrypted upgrader tar file for applications, Kernel, modules and bootloader) |
2. Use iCMS or the iG330 web interface to initiate a firmware download from releases of v2.7 or later, by entering the name of the encrypted file above as the "File name" and waiting for the upgrade to complete. Alternatively enter the command below on the serial console, where X.X.X.X is the IP address of the TFTP/SFTP server.
The new version of firmware can be confirmed from iCMS, the 'Home' web page or by executing GetVer.sh on the serial console.
The new version of U-boot can be confirmed by examining the serial console output during boot up.
If it is not possible to upgrade a unit using the steps above, then follow this full installation procedure to update all the NOR and NAND flash on the unit. The components that are upgraded are the bootloader (U-boot - Only suitable for 67MHz boards), the kernel (Linux), the FPGA and the complete Linux filesystem. This is a complete upgrade and any configuration stored on the unit will be lost; after the upgrade the unit will have a blank configuration. These installation instructions assume you have an iG330 with a bootloader previously installed and a serial cable attached to the iG330.
1. Copy the following files into the indicated directories below the root of your TFTP server.
| (U-Boot script to upgrade the entire firmware. Only suitable for 67MHz boards) | |
| (U-Boot script to upgrade the kernel & filesystem only. This can be safely applied to non-67MHz units) | |
| (U-Boot executable. Only suitable for 67MHz boards) | |
| (Altera FPGA image) | |
| (Linux kernel image) | |
| (JFFS2 file system) |
2. Connect the RS232 serial cable to the iG330. Connect the iG330 to the Ethernet LAN to access the TFTP server, using the 'NET 1' RJ45 socket on the iG330.
3. Using a terminal emulator program configured for 38400, 8-bit, no parity, 1 stop bit, no flow control, power up the iG330 and send it a character to stop U-Boot booting Linux. Ensure the terminal emulation program has a sufficiently large scroll buffer, e.g. 1000 lines, to view the history in step 6.
4. Use the iG330 U-Boot 'printenv' command to check its network settings.
If necessary, set the correct values with 'setenv' commands, e.g.
The settings except the TFTP server IP address can be set by DHCP, using the following command:
The 'dhcp' command should set 'ipaddr', 'netmask' and 'gatewayip' as they would be set in Linux, but it will set 'serverip' to the IP address of the DHCP server, so you will have to change it afterwards with 'setenv' if the DHCP and TFTP servers are not the same unit.
Save the new settings with the command:
5. Check that iG330 can access the TFTP server with the command:
The ping command should report "Using FCC2 ETHERNET device, host 10.12.1.58 is alive"
6. Download the U-Boot script onto the iG330 and run it to update the Flash with the commands below. If the version of U-Boot and FPGA are unchanged, or the unit to be upgraded has not been modified for 67MHz, the alternative U-boot script 'iG330_upgrade_kernel_jffs2_3-400-4-0.img' should be used instead in the line below:
The script will TFTP download the relevant files and program them into Flash. The U-Boot executable is downloaded and programmed into the NOR Flash as the last action by the script. Check in the RS232 console output that everything seemed to work correctly. In particular, check that the U-Boot image was correctly downloaded and programmed, as instructed by text at the end of the console output from the script. Note that it is normal for NAND flash to have some bad sectors and therefore some errors reporting these bad sectors are acceptable. If the U-Boot download and programming does not work correctly, do not reset or re-power the unit until after the script has been run again correctly, or you will probably end up with an iG330 that is unable to boot. When successful the unit should be restarted with the command:
Note that SSH operation will be enabled in the default configuration of the iG330 after loading the JFFS2 file system. There is a delay of a few minutes after SSH operation is enabled, while Linux generates SSH keys before it is possible to access the unit via an SSH program. These keys are only generated the first time Linux runs with SSH operation enabled after replacing the JFFS2 file system. When monitoring the console output, the unit reports "Generating SSH2 RSA host key: success..., Generating SSH2 DSA host key: success..., Generating SSH2 ECDSA host key: success..., Generating SSH2 ED25519 host key: success... & Starting sshd: success..." at which point it should be possible to access the unit via an SSH program.
Back
to the Index